home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / sharc851.arc / SHARC.DOC next >
Encoding:
Text File  |  1988-07-28  |  15.1 KB  |  283 lines
  1.  
  2.  
  3.                            SHARC Version 8.51                                  |
  4.                                7/27/88                                         |
  5.                          The SHell for ARC's                                    
  6.  
  7.                           By:  Jim Derr                                         
  8.  
  9.  
  10. Please note the the following Limit of liability statement was added            
  11. because I was told that there is a hacked version of this program               
  12. floating around some BBS'S.  The hacked version reportidly wipes out            
  13. the FAT on the disk that SHARC is running on.  Since I can't control            
  14. this please test out the version you get on a scratch floppy first.             
  15.  
  16.  
  17.                        LIMIT OF LIABILITY                                       
  18.  
  19. SHARC is distributed asis.  The author disclaims all warranties,                
  20. expressed or implied.  The author will assume no liability for damages          
  21. either from the direct use of this product or as a consequence of the           
  22. use of this product.                                                            
  23.  
  24.  
  25.  
  26. SHARC is a shell program to make viewing and working with ARC files user        
  27. friendly.  It is written in TURBOC with some screen I/O routines written       
  28. in ASM.  In order for SHARC do function you must have Phil Katz's PKARC        
  29. and PKXARC programs, and Vern Buerg's LIST program.                            
  30.  
  31. Please note that these programs are copyrighted and they can be obtained from   
  32. most BBS.                                                                       
  33.  
  34. PKARC.COM and PKXARC.COM                                                        
  35.  
  36. PKWARE, INC.                                                                    
  37. 7032 Ardara Ave.                                                                
  38. Glendate, WI. 53209                                                             
  39.  
  40. LIST.COM, by Vernon Buerg                                                       
  41. 456 Lakeshire,                                                                  
  42. Daly City, CA. 94015                                                            
  43.  
  44. This is the first release of SHARC and I am distributing it via                
  45. COMPUSERVE plus various BBS'S for comments and suggestions.  You can           
  46. leave comments on this BBS or contact me via COMPUSERVE I.D.                   
  47. 76266,2634.                                                                    
  48.  
  49. SHARC is fast and lean.  With it you can View, Extract, Add, Freshen,          
  50. Update, and Test most archive files.  To startup SHARC simply enter            
  51. SHARC d:\path\filespec.  SHARC will search your path looking for PKARC,        
  52. PKXARC, and LIST.  If these can not be found an error message will be          
  53. displayed and the program will terminate.  If all the supporting               
  54. programs are found the ARC file will be examined and you will be               
  55. presented with a screen showing the contents of the ARC file.                  
  56.  
  57. To perform a function simply position the highlite bar and press the key       
  58. that corresponds to the function you want to perform on that member.           
  59. Press the F1 key will open a window showing all valid command keys.            
  60.  
  61. If there is enough interest I will release updated versions of SHARC.           
  62.  
  63.  
  64. Please let me know how you like SHARC.                                          
  65.  
  66.                          Jim Derr                                               
  67.                          2425 Santa Cruz Ct.                                    
  68.                          Santa Rosa, Ca. 95401                                  
  69.                          CSERVE ID 76266,2634                                   
  70.  
  71.  
  72. Due to some suggestions by Bob Jacobson this is the second release of SHARC.    
  73. This release fixes a previous bug in SHARC that would hang the PC if wild       
  74. cards were specified on the command line.  WILDCARDS ON THE COMMAND LINE        
  75. ARE NOW SUPPORTED!                                                              
  76.  
  77. To move from one ARC file to another simply press the N key to look at the      
  78. next ARC file or press the ALT-N key to view the previous ARC file.             
  79.  
  80. Another enhancment is the addition of the ALT-D key.  Press this                
  81. combination will attempt to delete all previously extracted files from          
  82. either the current directory or the directory specified using the ALT-P         
  83. command.  (NOTE: USE THIS OPTION WITH CARE).                                    
  84.  
  85.  
  86. A little note on the ALT-P command.  This command prompts you for a             
  87. drive:\path to extract files into.  This path remains until you reset it       
  88. using the ALT-P again.  The path you specify is used to save extracted         
  89. files into and is also used when you use the ALT-D command.                    
  90.  
  91.  
  92.                             NOTES FOR RELEASE 3.0                               
  93.  
  94.  
  95. A file list window has been added in release 3.0.  This window replaces the     
  96. N command and ALT-N command.  When you specify wild cards on the command        
  97. line a filelist window will appear.  Use the cursor keys to highlight the       
  98. file you want to work with and press the enter key.  After the contents of      
  99. the ARC file are displayed you can POP-UP the file list window again by         
  100. simply pressing the N key.                                                      
  101.  
  102.                             NOTES FOR RELEASE 4.0                               
  103.  
  104. Support for monochrome monitors has been added.  Sharc automatically senses     
  105. a monochrom monitor and adjusts the screen attributes for the monitor.          
  106.  
  107. Two small "bugs" have been corrected.  When an extract path is entered it       
  108. stays in effect for the entire session or until you change it.  The window      
  109. scrolling routine was corrected to correctly handle the end and cursor          
  110. down keys after selecting a file for extraction or viewing.                     
  111.  
  112.  
  113.  
  114.  
  115. As usual any and all comments are welcome. If there are some features that      
  116. are missing drop me a note and I'll try to accomodate you if I think the        
  117. feature is generally usefull.                                                   
  118.  
  119.                            NOTES FOR RELEASE 4.1                                
  120.  
  121. The release adds support for release 3.6 of PKARC and PKXARC.  SHARC            
  122. will automatically determine which version is on your machine and will          
  123. use whichever version it finds.                                                 
  124.  
  125.                            NOTES FOR RELEASE 6.0                                
  126.  
  127. Please note that there was no version 5.x.                                      
  128. Release 6 add addition support of version 3.6 of PKARC.  You can now TAG        
  129. files for extraction by pressing the space bar to toggle the TAG status.        
  130. Then press the CTRL-E key to extract all tagged files.                          
  131.  
  132. For those of you that have monochrome monitors and can't see the selection      
  133. bar try setting the environment variable mono=y.  I.E. SET MONO=Y.  I think     
  134. this should solve the problem.                                                  
  135.  
  136.                            NOTES FOR RELEASE 6.1                                
  137.  
  138. This release has added the M move option.  This option will allow you to        
  139. specify which files to move into the currently selected archive file.          
  140. If the files are successfully moved they will be deleted.  Also if sharc       
  141. detects an error from PKARC or PKXARC a message will be displayed on the       
  142. screen and the screen will not be cleared until a key is pressed.              
  143.  
  144.                            NOTES FOR RELEASE 6.2                                
  145.  
  146. This release fixes a bug when SHARC is started and you specify a file on       
  147. the command line.  Prior to this release if you specified a file on the        
  148. command line then used the N command SHARC would terminate.  Under Rel.        
  149. 6.2 SHARC will now present a list of all files in the current directory        
  150. that have a file extension of .ARC.                                            
  151.  
  152.                            NOTES FOR RELEASE 6.3                                
  153.  
  154. This release fixes a problem that occurs when tagging files for                
  155. extaction. Under the prior release if you tagged the last entry in the         
  156. ARC file for extraction it would not be extracted. Version 6.3 fixes           
  157. this problem.                                                                  
  158.  
  159.                            NOTES FOR RELEASE 7.0                               
  160.  
  161. This release adds the ability to execute a exe or com file from within         
  162. the ARC file.  The exe or com file is extracted into the current               
  163. drive:\directory then you are prompted to enter any command line options.      
  164. The program is executed and then deleted.                                      
  165.  
  166.                            NOTES FOR RELEASE 8.0                               
  167.  
  168. This release address numerous comments from users of SHARC over the past       
  169. few month.  The program has been corrected so that the cursor is restored      
  170. when SHARC is finished executing.  The following list documents features       
  171. that have been changed and/or added.                                           
  172.  
  173.     1.  The file list is now sorted and can be scrolled up and down in         
  174.         addition to being able to page up and down.                            
  175.  
  176.     2.  Four new commands have been added. They all prompt for a filespec      
  177.         which can include drive and path information.  A file list is then     
  178.         presented based on the entered file specification. When the file
  179.         list is on the screen use the SPACE bar to toggle the tagged status
  180.         of the file.  (IF a file is tagged the ยป character will appear to
  181.         the left of the displayed file.) When you have tagged all the files
  182.         that you want included in the operation (ADD, FRESHEN, MOVE, UPDATE)
  183.         press the ENTER key and all tagged files will be acted upon.
  184.  
  185.         The four new command keys are:
  186.         ALT-A  to add a list of files to the current ARC file.
  187.         ALT-F  to freshen a list of files to the current ARC file.
  188.         ALT-M  to move a list of files into the current ARC file.
  189.         ALT-U  to update a list of files in the current ARC file.
  190.  
  191.     3.  If you start SHARC by specifying wild cards on the command line
  192.         pressing the ESC key will return you to the file list presented
  193.         when SHARC was first started.  To exit SHARC press the ESC key
  194.         again.
  195.  
  196.                            NOTES FOR RELEASE 8.2
  197.  
  198. This release supports updating an ARC file using the ALT-A, ALT-F, ALT-M
  199. and ALT-U commands, when the files are in a different directory than the
  200. ARC file.  PLEASE NOTE THAT THESE COMMANDS REQUIRE PKARC 3.6.
  201.  
  202. The S command has been added. It allows you to switch to other ARC files
  203. in directories other than the one specified on the command line.
  204.  
  205. The C command has been added. It allow you to create a new ARC file.
  206. When specifing the new ARC file you can enter the disk and directory you
  207. want the ARC file to reside in.  THIS COMMAND ALSO REQUIRES PKARC 3.6.
  208.  
  209. I have also included a registration form file with this release.  If you
  210. have been using SHARC please register!!!
  211.  
  212.                            NOTES FOR RELEASE 8.3
  213.  
  214. This release supports ARC'S with up to 1098 files in an ARC file. A new
  215. option has been added to display ARC and file comments within the ARC file.
  216. To use this option press ALT-I.  The implementation of this option is now
  217. very elegant but it works.
  218.  
  219.                            NOTES FOR RELEASE 8.4
  220.  
  221. Fixed a minor bug in the command line parsing routine.
  222.  
  223.                            NOTES FOR RELEASE 8.5
  224.  
  225. This release adds a speed search facility to both the file list pop-up
  226. window and the ARC file list.  To use the speed search ficility in the
  227. pop-up window simply press the first letter of the file name you want
  228. to scroll to.  The list will be repositioned to the file that starts with
  229. that letter or the closest thing to it.  To use the speed search facility
  230. within an ARC display press ALT-S and then press the first letter of the
  231. file name you want to find then press enter.
  232.  
  233.                            NOTES FOR RELEASE 8.51                              |
  234.                                                                                |
  235. An enhancement has been added in this release that positions the file list     |
  236. display pointer to the last file selected. The list is still scrollable        |
  237. and pagable, SHARC just remenbers the last ARC file you selected from          |
  238. the list and positions the pointer to that file for you the next time          |
  239. the file list is displayed.                                                    |
  240.  
  241.  
  242.                            NOTES TO REGISTERED USERS
  243.  
  244. Release 8.5 is the last release for a while.  If you are a registered
  245. user I will accept BUG reports from you and will correct them post hast.
  246. If you are not a registered user I will still accept BUG reports but
  247. the corrections will take a back seat to the registered user's requestes.
  248.  
  249.  
  250.                    WHERE TO FIND THE MOST CURRENT VERSION                      |
  251.                                                                                |
  252. The following BBS's will have the most current version of SHARC.               |
  253.                                                                                |
  254. EXEC-PC                     414-964-5160                                       |
  255. MICRO SELLAR                201-239-1346                                       |
  256. AV-SYNC                     404-320-6202                                       |
  257. TURBO SEARCH                617-545-9131                                       |
  258. VERN BUERG BIT BOUTIQUE     707-778-8944                                       |
  259. SONOMA BBS                  707-792-0963                                       |
  260. COM-ONE                     415-284-9151                                       |
  261.                                                                                |
  262. In addition it can also be found on COMPUSERVE in the IBMSW forum.             |
  263.  
  264.                            Additional Stuff
  265.  
  266. I have spent many hours on this program trying to make it as easy to use
  267. as possible and reasonably fast. I have also tried to be responsive to
  268. user comments and requests.  Also note that the program is not crippled in
  269. any way.  It is a fully functional program.
  270.  
  271. Since this program has developed into a major undertaking all I ask is if
  272. you use it regularly PLEASE SEND A CONTRIBUTION OF $7.00, and keep
  273. shareware alive.
  274.  
  275. Let your conscience be your guide.
  276.  
  277.             Jim Derr
  278.             2425 Santa Cruz Ct.
  279.             Santa Rosa, Ca. 95401
  280.  
  281. Many thanks to the people that have given me feed back, comments, and
  282. suggestions for improving SHARC, especially Bob Jacobson.
  283.